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Object Serialization in Java 1.1 

Making Objects Persistent 

By Chad Darby 

Java 1,1 Introduces object serialization, an easy-to-use and easy-to-implement 
data-storage method that eliminates worries about file formats. Object 
serialization lets you save an object's state, thereby saving the values of the data 
members and functionality of the methods. In effect, this provides object 
"persistence." Say, for example, you are writing a computer game with a save 
option, if the player's state information — position, score, and so on - Is 
maintained in a game object, you can simply serialize that object to a disk file. 
The serialization will recursively save all objects pointed to by the game object; 
then, when the player restarts the game, only the game object must be reloaded. 

In this article we will step through object serialization using a simple class, then 
focus on Its Implementation in a real-world application, (For more on object 
serialization, see Bruce Eckel's July 1997 "Java Alley - column In Weo Techniques.) 

customer Class Design 

To illustrate serializing an object, we will use a simple customer class that holds a 
customer's name and age; see Figure 1, The class will override the tostringo 
method to provide a string representation; however, the real meat of this example 
will be in the load ( ) and save ( ) methods, which provide the actual code for 
reading and writing serialized objects. 

To read or write the state of an object to or from a stream, the class must 
implement the java. io. serial izabie Interface. This Interface does not contain 
any methods or static data members; It Is merely a tag Indicating that the class 
can be serialized. Listing One contains the skeleton class declaration of customer. 

Writing Objects to a Stream 

Writing objects to a stream resembles writing primitives to output streams and 
Involves the following steps: 

1. Create a pi leoutput stream object for the data file. 

2. Create an objectqutputstream using the specified FileOutputstream. 

3. Write the object to the stream. 

4. Close the stream. 

The customer class has a saveO method that will contain the code for writing the 
object to a stream; see Listing Two. 

The save ( ) method takes as its parameter a filename that Is then used to create 
the object's FileOutputstream, which is In turn used to create an 
objectoutputstream. The ob j ectoutputstream writes the object to th stream 
with the slmpl cali cos .wrlteObject(thls);. 

An iosxception will be thrown if the file cannot be open d for writing or If 
problems are encountered while accessing the object or its fields. The save() 
method's throws keyword Is used to list the xceptions the method can throw, 
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forcing the programmer using the Customer class to handle the exceptlon(s). 

After the object is written, we flush and close the ObjectOutputStream, and the 
object Is saved to a file. 

To save an instance of the Customer class to disk, we simply call Its save ( ) 
method and pass a filename string. 

Reading Objects from a Stream 

Serialization makes it easy to read objects from an object stream: Calling the 
readobject ( ) method returns the state of a saved object, regardless of the format 
in which It was saved. 

Reading an object from an Input stream entails the following steps: 

1. Creating a Fileinputstream for the data file. 

2. Creating an ObjectlnputStream using the Specified Fileinputstream. 

3. Reading from the input stream. 

4. Closing the stream. 

The loadO method takes a filename as a parameter and returns a customer 
Object; see Listing Three. A Fileinputstream and Object Input Stream are created 
in a fashion similar to the eaveO method. The statement 
tempCustomer- (Customer) ois .readObject ( ) ; reads the Object from the 
stream, after which it must be cast to our class. If a compatible class Is not found, 
the ciassNotFoundException Is thrown. An lOException may also be thrown 
since we are dealing with file I/O. Again, because of the throws keyword In the 
method declaration, the programmer must handle the exceptions 
CiassNotFoundException and lOException when calling the loadO method. 

The load () method is declared as static and is therefore available class-wide. You 
can call static methods without referencing any particular object, so they are 
commonly used for "utility" methods. In this case, ioad ( ) is a utility for the 
Customer class; because it Is static, we can easily call It from our driver using 
anyttistomer-Customer. load (« foo.bar") After the object Is read, we Can Close 
. the ObjectlnputStream. 

Putting It AH Together 

Having added the functionality needed for object persistence to our Customer 
class, we now need a driver to test It. In the driver, we will create one customer 
object and save It to a file, then load the object from the file and display the 
contents. 

Listing Four gives the code for the Customer Driver. Two objects of customer are 
declared: customerA and customerB. We create a new customer object and pass it 
the initial values name^janine" and age- 24L Then we save customerA to the disk 
file foo.bar. By saving the object, we are In fact serializing It 

The object is loaded from foo.bar by calling the loadO method and passing in the 
filename. The loadO method returns a customer object, which is assigned to 
customerB; Because loadO Is static, we don't have to reference a particular 
customer object, only the class name. In this example, the loadO method 
actually deserializes the object from the Input stream. 

Now that we have successfully loaded an object from the input stream, we can call 
its methods. The System, out. print Xn{) statement calls the Customer object's 
tostring () method, which accesses the object's data members and displays its 
contents. Additional public methods or data can also be referenced. 

This simple example of object serialization used the default methods 
writeobject () and readobject (); to control the Information saved or restored, 
th y could have been overridd n. Furth rmore, Instead of the Seriaiizable 
interface, we could have Implemented the Exteraaiizable Interface, which saves 
only the class's Identity; the class would then have to provide methods to save 
and restore the cont nts. 
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A Web-Based Reporting System 

Now I'll move on to a real-world example: Implementing object serialization to 
serve as a light-weight database and create dynamic Web pages based on the data 
stored In the serialized objects. 

My Intranet object-serialization example takes place at a fictional company called 
Mlkar Tech. The Information Technology (IT) shop at Mlkar Tech would like a 
Web-based collaborative reporting application. The company is in the process of 
installing a new sales-support system for their four regional divisions, and the Web 
application will give them the capability to monitor and update the project status. 

Key members of the IT shop agreed that the Web application should provide the 
following functionality: 

1.1. The ability for regional project managers to provide weekly reports via a 
Web- based form. 

2. 2. The ability to view a one-page summary of ail weekly reports with 
"stop-light" status indicators. 

3. 3. The ability to drill down through the summary to get detailed 
Information. 

Design Solution 

A traditional HTML form on the client side will be used to gather data for the 
weekly reports. The data will then be submitted to a Java-CGI program residing on 
the Web server; see figure 2. This Java-CGI program will perform the following: 

1. Store the weekly reports based on the form data as a serialized object. 

2. Create a dynamic Web page for weekly reports and save to disk. 

3. Create a dynamic Web page for summary reports based on all weekly 
reports submitted and save the page to disk. 

4. Return the weekly report page to the user for viewing. 

The main driver of the Java-CGI application is the statusUpdate class, 
statusupdate makes the high-level calls to produce the functionality outlined in 
the design. Listing Five Is the code fragment for the main routine In the 
StatusUpdate class. 

The Weekly Report 

Each week, the regional project managers will submit a weekly report via a 
Web-based form. The weekly report Is composed of status ratings on project 
features: client software, database server, Internet connectivity, and user training. 

When the manager rates the status of each feature, they wilt use red, yellow, or 
green. For example, If the client software has not been Installed, this feature will 
be assigned red. If work Is In progress, the feature will be rated yellow. Finally, If 
a feature Is completed, it is rated green. This assignment of color codes gives the 
ability to provide a stop-light grid for the summary report. 

After the project manager enters the data for the weekly report and submits the 
report, the Java-CGI program will perform the following functions: 

1. Stores the weekly report based on the form data as a serialized object. 

2. Creates a dynamic Web page for the weekly report and saves It to disk. 

The Weekly Report as a Serialized Object 

During the object-oriented analysis and design phase; three classes were Identified 
as the heart and soul of the system; see Figure 3 and 4. Each division's weekly 
report data needs to be stored. A Division object will contain the name of the 
division (Seattle, WA), a pointer to th division's ProjectManager and a list of all 
. the project features. By leveraging object serialization, we can easily save the 
state of this object. 

Since we nly had four company divisions to handle, it would have been overkill to 
use relational-database access. By using object serialization, we did not waste 
valuable development time creating a scheme to read and write the data to a disk. 
Object serialization eliminated the need to save program information to flat text 
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files or add relational-database connectivity. 

to save the state of the Division object, you need to provide a method for 
saved and loadO for the Division class. Listing Six Is code fragment for the 
saved method. Enhancements were made for saving the object to a data 
directory and a very simple file-locking mechanism was added, (Code for the 
loado method will be discussed in a later section.) 

Once the save o method for the Division object Is called, the complete state data 
for the object is stored In a file titled <division>. division (for example, 
Seattle.divlslon). 

After the division's weekly report is saved as a serialized object, a dynamic Web 
page can be created. The Division class has a publishWeeklyReport {) method, 
which actually calls a number of utility routines to bultd the different portions of an 
HTML page; heading, navigation bar, body, and the bottom. The heart of this 
method is in the call to buiidBodyO method. Listings Seven and Eight provide the 
code for publishWeeklyReport () and buildBodyd, respectively. 

The Feature class provides a method to webstring( ) , which gives an 
HTML-formatted string of its data members (see Listing Nine). 

The HTML tags are embedded In the string. This string information Is returned to 
the calling method while the string is used to build the weekly report Web page. 
This Web page is saved to disk as a flat text file. Since this file has HTML tags, it 
can later be viewed by a Web browser. 

The Project Summary Report \ 

The project summary report Is a one-page summary of all weekly reports. The 
summary gives a graphical display of the weekly reports with "stop-light" status 
indicators. This report is useful for determining the project status of all divisions at 
a glance. While viewing the summary report, the user can drill down for specific 
details in problem areas. 

Creating the project-summary report Involves loading serialized objects for all 
divisions and generating HTML tables with data from Division objects. 

Loading serialized objects. To create the summary report, the serialized object 
for all divisions must first be loaded. This load process Is easy thanks to serialized 
objects, the loadO method Is very similar to what was presented In the "how-to" 
section of this article. Enhancements were made for saving the object to a data 
directory and again, we Implemented a simple file-locking mechanism (see Listing 
Ten). 

Loading division objects. To load all of the Division objects, you can simply 
write a for loop that calls the loadO method for each one. The Division objects 
will be stored In a vector, which Is a growable array. Listing Eleven Is the code 
fragment for loading the Division objects. This method Is a member of the 
statusupdate class, which serves as the main driver for the application. 

HTML Table for Summary Report 

Basically, the summary report is a table that lists the project data for each 
division. Every time a new weekly report Is submitted, the status grid must update 
to display the latest information (see Listing Twelve). 

The bulk of the code is In the buildQridt) method, which actually traverses the 
vector of Division objects and creates an HTML table with the data (see Listing 
Thirteen). 

The normal HTML tag for a table Is <table border-l width-ioo%>. For the first 
row of the table, we create a heading by listing the names of each Division 
object. Each Division object has a nanieToGridstring ( ) method that returns the 
name of the Division object with HTML table tags (for example, 
<td>Houston</td>). 

Once the grid heading Is created, the data will be listed for ach feature of the 
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project (Client Software, Database Server, Internet Connectivity and User ^ 
Training). Each Feature object has a BtatusToGridSt ring () method t a ^ 
return a string representation of the status. The actual string *>as HTML ta ^ - ^ 
to display a GIF image. So, for example, if we had the following data for a a 

Division Name: Houston 
Feature Name: User Training 
Feature Status: red 

the HTML string returned would look like Example 1. After all of the features are 
displayed, a final row is added at the bottom to display the date of the last report 
update. 

When users view the HTML table, they wilt be able to get the project status of all 
divisions at a glance. If they want details on a specific problem area, clicking on 
the status image will allow them to drill down to the details on the weekly report 
created earlier. 

Conclusion 

Equipped with the knowledge about Implementing serialized objects, you can 
easily integrate the 3ava object-serialization technology In your next Intranet 
application. The full source code is available at 
www.j-nine.com/pubs/Webtech-sep97. 

(Get the source code for this article here.) 



Chad (shod) is the principal consultant at J9 Consulting, www.j-nlne.com, where 
he specializes In developing server-side Java applications. He can be reached at 

darby@j-nine.com. 
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